Linking rules

Link value stream tools to one another.

Link rules define how integrated tools relate to one another. When tools are linked, objects that appear in a value stream provide information and links to the associated tools. You might link an issue tracking system, for instance, to a source control tool.

To define a link rule, specify a field in the linked-from tool that you want to associate with a field in the linked-to tool, and a regular expression that defines the matching pattern.

The following example illustrates how to link a Git integration with a Pivotal integration:

• The "fromIntegrationName": "my-github" property identifies the Git integration defined in the value stream.
• The "fromField": "pr.name" property links the Git pull request name to the linked-to tool.
• The "toIntegrationName": "my-pivatol" property identifies the Pivotal integration defined in the value stream.
• The "toField": "issue.id" property links the Pivotal issue ID to the linked-from tool.
• The "pattern": "[[A-Z]+-[0-9]+}" property defines the regular expression that determines if potential links match.

      "linkRules": [
        {
          "toIntegrationName": "my-pivatol",
          "toField": "issue.id",
          "pattern": "[[A-Z]+-[0-9]+]",
          "fromIntegrationName": "my-github",
          "fromField": "pr.name",
        },
       ]

When links are established, you can access information about the linked tools from the affected dots in the value stream. In general, you can define linking rules for any integrated tools, and define multiple linking rules in a single value stream.